home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / comm / bbs / PagEr.lha / PagE!r / PagE!r.txt < prev    next >
Text File  |  1996-11-10  |  6KB  |  176 lines
  1.  
  2.                                 P a g E ! r
  3.                                 ~~~~~~~~~~~
  4.                              v1.0  by Morpheus
  5.  
  6.     Introduction.
  7.     ~~~~~~~~~~~~~
  8.  
  9.  PagE!r is a sysop pager for Excelsior! BBS. To show you what its features
  10.  are I will simply sum up what happens when a user invokes PagE!r:
  11.  
  12.   1. PagE!r asks the user the reason for paging the sysop.
  13.  
  14.   2. PagE!r checks whether the sysop is available or not.
  15.  
  16.   3. If the sysop is not available then an ansi-screen ("Sysop not available")
  17.      will be shown to the user and PagE!r will ask the user if he wants to
  18.      leave feedback.
  19.  
  20.   4. If the sysop is available then an ansi-animation will be shown to the
  21.      user while PagE!r notifies the sysop.
  22.  
  23.   5. The sysop is notified by playing a sound sample and showing a GUI on the
  24.      WB screen which has the gadgets Chat, IUM, Busy, Unavailable, Abort.
  25.  
  26.  
  27.     Files.
  28.     ~~~~~~
  29.  
  30.  The following files should be included in this archive:
  31.  
  32.     PagE!r/PagE!r               -   The main ARexx script
  33.     PagE!r/PagE!r.txt           -   This text file
  34.     PagE!r/SysopAvail.rexx      -   Utility for (re)setting the avail-flag
  35.     PagE!r/PagE!r.ansi          -   Ansi-anim showed while paging
  36.     PagE!r/NotAvail.ansi        -   Ansi-screen showed when sysop is not
  37.                                     available
  38.     PagE!r/PagE!r.sound         -   The sound sample
  39.     PagE!r/PagE!r_sysop         -   ARexx script invoked by the PagE!r-script
  40.     PagE!r/PagE!r_player        -   ARexx script invoked by the PagE!r-script
  41.     file_id.diz
  42.     libs/rexxarplib.library
  43.     libs/screenshare.library
  44.  
  45.  
  46.     Installation.
  47.     ~~~~~~~~~~~~~
  48.  
  49.  The installation of PagE!r can be quite complicated for some people
  50.  (but not for YOU of course :-) , but I hope it won't stop you from trying
  51.  out this utility!
  52.  
  53.  1. Copy the two libraries (rexxarplib.library and screenshare.library) from
  54.     the libs directory to LIBS:
  55.  
  56.  2. Create a new directory for PagE!r (the default path is Doors:PagE!r)
  57.  
  58.  3. Copy all the files from the PagE!r-directory to the new directory that
  59.     you just created
  60.  
  61.  4. Edit the file "PagE!r" and change the "path" and "rxpath" settings at
  62.     the top of this file to your settings
  63.  
  64.  5. (optional) Edit the file "PagE!r_sysop" and change "busymsg" and
  65.     "chatmsg" to messages that are much more fun than mine ;)
  66.  
  67.  6. Edit the file "PagE!r_player" and change "playcmd", "playwhat", "play_nr"
  68.     and "pause" to the for the sample player you use
  69.  
  70.  7. (optional) Replace the files "PagE!r.ansi" and "NotAvail.ansi" with
  71.     ansi-anims and/or screens that you like
  72.  
  73.  8. Add the following line to your BBS-startup file (if you have any, and if
  74.     you don't: create one! :-)
  75.  
  76.         rx [PagE!r-path]/SysopAvail.rexx [x] [y]
  77.  
  78.     [PagE!r-path] should be replaced with the path to the SysopAvail-script
  79.     and you can optionally replace [x] and [y] with the coordinates for the
  80.     starting position of the SysopAvail-window.
  81.  
  82.     For example:
  83.  
  84.         rx Doors:PagE!r/SysopAvail.rexx 20 40
  85.  
  86.     this will open a window at the (x,y)-postion (20,40).
  87.  
  88.  9. Edit your "EX.BBSMenus" file. Go to the Global Commands section and
  89.     find the line for the 'C'-command. This line will look something like:
  90.  
  91.        501,     C,      0,      "1-32",     ""
  92.  
  93.     Change this line into :
  94.  
  95.        501,     COLD,   0,      "1-32",     ""
  96.  
  97.     Now go to the bottom of the Global Commands section and add the
  98.     following line to it:
  99.  
  100.        566,     C,      0,      "1-32",     "\#0Doors:PagE!r/PagE!r\"
  101.        ~~~                                      ~~~~~~~~~~~~~
  102.         |                                             |
  103.         `-> Make sure that this is a new              |
  104.             (unused) command-value                    |
  105.                                                       |
  106.                      path where PagE!r is located  <--'
  107.  
  108.     After reloading the "EX.BBSMenus" file the new pager can be activated by
  109.     entering 'C' at the command prompt.
  110.  
  111.  
  112.     Usage of SysopAvail.
  113.     ~~~~~~~~~~~~~~~~~~~~
  114.  
  115.  Because I have no idea how to check the internal avail-flag in E! with
  116.  ARexx, I have written a small script to set and reset a new avail-flag
  117.  that is used by PagE!r.
  118.  
  119.  I think that the usage of this utility will be quite clear when you've
  120.  started it.
  121.  
  122.     - The "Avail"-gadget will set the avail gadget
  123.     - The "Not Avail"-gadget will reset the avail gadget.
  124.  
  125.  
  126.     Usage of the GUI.
  127.     ~~~~~~~~~~~~~~~~~
  128.  
  129.  When you're being paged you will hear a sound sample and a GUI on the WB
  130.  screen will pop to the front. This GUI contains the name of the user that
  131.  paged you, the port number that he/she is on, the reason for paging and the
  132.  following gadgets:
  133.  
  134.     Chat        -   Activating this gadget will open the BBS screen of the
  135.                     user that paged and pop it to the front. You can now
  136.                     activate the chatter in the "User Menu" of the BBS screen
  137.                     and chat with your user.
  138.  
  139.     IUM         -   You can enter a message and send it to the user by
  140.                     activating this gadget.
  141.  
  142.     Busy        -   Activating this gadget will send a standard busy-message
  143.                     to the user.
  144.  
  145.     Unavailable -   This gadget resets the avail-flag.
  146.  
  147.     Abort       -   Abort... :)
  148.  
  149.  After activating one of the gadgets the GUI-window will be closed.
  150.  
  151.  
  152.     Registration.
  153.     ~~~~~~~~~~~~~
  154.  
  155.  All you have to do to register this utility is send me a message with your
  156.  address. It's always nice to know who's using my programs :))
  157.  
  158.  
  159.     Author.
  160.     ~~~~~~~
  161.  
  162.  If you find any bugs, problems or if you've got a great idea for another E!
  163.  door, then mail me at one of the following addresses:
  164.  
  165.     FIDO:   2:285/1.40
  166.     AmyNet: 39:157/107.4
  167.     NLA:    14:105/204.4
  168.  
  169.     E-mail: robin@te.xs4all.nl
  170.  
  171.     Robin Michielsen
  172.     Puntstraat 23
  173.     4543 CW  Zaamslag
  174.     The Netherlands
  175.  
  176.